Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 16 - Storage Objects / Storage Objects Reference

Storage Objects Routines / Creating and Accessing UNIX Path Name Storage Objects

Q3UnixPathStorage_New

You can use the Q3UnixPathStorage_New function to create a new UNIX storage object specified using a path name.

TQ3StorageObject Q3UnixPathStorage_New (const char *pathName);

pathName

A path name of a file. The path name is a null-terminated C string.

DESCRIPTION

The Q3UnixPathStorage_New function returns, as its function result, a new storage object associated with the file specified by the pathName parameter. The specified file is assumed to be closed. QuickDraw 3D opens the file (by calling fopen) and, when the associated storage object is closed or disposed of, QuickDraw 3D closes the file (by calling fclose). If Q3UnixPathStorage_New cannot create a new storage object, it returns the value NULL.

ERRORS

kQ3ErrorOutOfMemory
kQ3ErrorNULLParameter